home *** CD-ROM | disk | FTP | other *** search
/ Aminet 22 / Aminet 22 (1997)(GTI - Schatztruhe)[!][Dec 1997].iso / Aminet / util / cdity / cgxdpms.readme < prev    next >
Text File  |  1997-11-02  |  6KB  |  186 lines
  1. Short:    DPMS manager for CyberGraphX. V1.2
  2. Author:   Magnus Holmgren (cmh@lls.se)
  3. Uploader: Magnus Holmgren (cmh@lls.se)
  4. Type:     util/cdity
  5.  
  6.  
  7. Introduction
  8. ============
  9.  
  10. CGXDPMS - Now there's an acronym for you. ;) CGX stands for CyberGraphX,
  11. and DPMS stands for Display Power Management Signaling. So, this is a
  12. program that uses the DPMS feature in CyberGraphX.
  13.  
  14. Anyway, this is a small program I hacked together the other day (hence the
  15. brief documentation ;). It is a small commodity that uses the DPMS function
  16. in your graphics card and monitor. I wrote it since the DPMS program I had
  17. seen was a bit large, and more importantly, didn't support all DPMS levels
  18. available in CyberGraphX. Hence CGXDPMS, which supports all three DPMS
  19. levels (and is a bit smaller).
  20.  
  21. CGXDPMS can be used in addition to a normal screen blanker.
  22.  
  23.  
  24. Requirements
  25. ============
  26.  
  27. First of all, you need a graphics card and a monitor that supports DPMS.
  28. You also need CyberGraphX (or compatible) installed. Other than that,
  29. nothing special is required (except AmigaOS then).
  30.  
  31. If you use this with a graphics card that do support DPMS, but the monitor
  32. does not, I don't know what will happen. If anything gets damaged, don't
  33. blame me. And this brings us to...
  34.  
  35.  
  36. No warranty
  37. ===========
  38.  
  39. There is no warranty for this software package. Although the author has
  40. tried to prevent errors he can't guarantee that the software package
  41. described in this document is 100% reliable. You are therefore using this
  42. material at your own risk. The author cannot be made responsible for any
  43. damage which is caused by using this software package.
  44.  
  45.  
  46. Usage
  47. =====
  48.  
  49. The following arguments can be specified on the command line, or as
  50. tooltypes:
  51.  
  52. CX_PRIORITY
  53.     The priority (within Commodities), for the hotkeys and similar.
  54.     Default is 0.
  55.  
  56. BLANKKEY
  57.     Description of the hotkey to make CGXDPMS go to the "first" DPMS
  58.     mode. I.e., if STANDBYTIME is 0 and SUSPENDTIME is not, then
  59.     pressing the hotkey will activate the suspend mode. Default is ""
  60.     (i.e. no hotkey).
  61.  
  62. STANDBYTIME
  63.     The number of minutes of inactivity to wait before the (optional)
  64.     standby mode should be activated. Default is 15 minutes. Specifying
  65.     0 will make CGXDPMS skip this mode.
  66.  
  67. SUSPENDTIME
  68.     The number of minutes of inactivity to wait before the suspended
  69.     mode should be activated. This time starts counting after the
  70.     standby mode is activated (if at all). Default is 15 minutes.
  71.     Specifying 0 will make CGXDPMS skip this mode.
  72.  
  73. OFFTIME
  74.     The number of minutes of inactivity to wait before the off mode
  75.     should be activated (erh ;). This time starts counting after the
  76.     standby mode is activated (if at all). Default is 15 minutes.
  77.     Specifying 0 will make CGXDPMS skip this mode.
  78.  
  79.     Note: Setting all the above times to zero is rather pointless to
  80.     do, don't you think? ;) There's not check for it...
  81.  
  82. SENDSHIFT
  83.     In order to stop a possible screen blanker from doing any
  84.     uneccessary work, CGXDPMS will regularly emulate the pressing of
  85.     the left shift key while the monitor is not "on", if this switch is
  86.     specified. This should keep any screen blanker from going into
  87.     action.
  88.  
  89.     Pressing the shift key shouldn't cause any problems, but here you
  90.     can decide if it should be done or not.
  91.  
  92. SHIFTTIME
  93.     The number of minutes to wait between the emulated shift pressings.
  94.     Default is 1.
  95.  
  96. NOMOUSE
  97.     If specified, then the CGXDPMS will not turn the monitor on when
  98.     the mouse is moved. This only affects CGXDPMS while the monitor is
  99.     not "on".
  100.  
  101.  
  102. The DONOTWAIT tooltype in the icon is for the Workbench, when placed in the
  103. Workbench startup drawer.
  104.  
  105.  
  106. Todo?
  107. =====
  108.  
  109. Things that could be added, but I didn't consider to be important at the
  110. moment:
  111.  
  112.  o CGXDPMS assumes that it is the graphics card of the Workbench screen
  113.    that should be signaled for power saving. Maybe this should be
  114.    configurable (in the form of the name of a public screen), and also
  115.    include support for multiple screens (for those with multiple cards).
  116.  
  117.  
  118. Author and other things
  119. =======================
  120.  
  121. CGXDPMS was written in 1997 by Magnus Holmgren. It is public domain (source
  122. included, though not very well documented ;), so you can do anything you
  123. like with it (although credits would be appriciated ;). Contact address:
  124.  
  125. Snail mail:
  126.  
  127.     Magnus Holmgren
  128.     Kvarnbergsvägen 5
  129.     S-444 47  Stenungsund
  130.     SWEDEN
  131.  
  132. Electronic mail:
  133.  
  134.     cmh@lls.se
  135.     2:203/512.10@fidonet
  136.  
  137.     http://www.lls.se/~cmh/
  138.  
  139.  
  140. Version history
  141. ===============
  142.  
  143. 1.0    May 7, 1997
  144.  
  145.     Initial release.
  146.  
  147. 1.1    July 27, 1997
  148.  
  149.     CGXDPMS wouldn't go through all DPMS states, due to a silly bug...
  150.  
  151.     CX_PRIORITY wasn't properly handled, but since there was no hotkey,
  152.     this shouldn't have caused any problems.
  153.  
  154.     Added BLANKKEY argument, that makes CGXDPMS go to the "first" DPMS
  155.     mode.
  156.  
  157. 1.2    October 9, 1997
  158.  
  159.     Gunther Nikl sent me an updated version of the source, and I
  160.     incorporated most of his changes into "my" source. Things changed:
  161.  
  162.         Error reporting had a couple of quirks.
  163.  
  164.         Did some small changes, and made it easier to compile with
  165.         GCC (though I did not add all things).
  166.  
  167.         Need for utility.library removed (the compiler didn't need
  168.         utility where I thought it would ;).
  169.  
  170.         Compiled for 68020+ (and optimized for 68040), since
  171.         CyberGraphX requires 68020 anyway.
  172.  
  173.  
  174. ============================= Archive contents =============================
  175.  
  176. Original  Packed Ratio    Date     Time    Name
  177. -------- ------- ----- --------- --------  -------------
  178.     3428    2090 39.0% 09-Oct-97 21:25:10  CGXDPMS
  179.    14001    4812 65.6% 08-Oct-97 18:08:30  CGXDPMS.c
  180.     3818    1981 48.1% 26-May-97 23:12:16  CGXDPMS.info
  181.     5221    2357 54.8% 09-Oct-97 21:24:04  CGXDPMS.readme
  182.     2114     934 55.8% 18-May-97 11:53:16  CGXDPMS.readme.info
  183.      451     269 40.3% 09-Oct-97 21:24:40  SCOPTIONS
  184. -------- ------- ----- --------- --------
  185.    29033   12443 57.1% 11-Oct-97 04:05:58   6 files
  186.